home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / assert.z / assert
Encoding:
Text File  |  2002-10-03  |  2.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaasssssssseeeerrrrtttt((((3333XXXX))))                                                          aaaasssssssseeeerrrrtttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _aaaa_ssss_ssss_eeee_rrrr_tttt - verify program assertion
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_aaaa_ssss_ssss_eeee_rrrr_tttt_...._hhhh_>>>>
  13.  
  14.      _vvvv_oooo_iiii_dddd _aaaa_ssss_ssss_eeee_rrrr_tttt _((((_iiii_nnnn_tttt _eeee_xxxx_pppp_rrrr_eeee_ssss_ssss_iiii_oooo_nnnn_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      This macro is useful for putting diagnostics into programs.  When it is
  18.      executed, if _e_x_p_r_e_s_s_i_o_n is false (zero), _aaaa_ssss_ssss_eeee_rrrr_tttt prints
  19.  
  20.           Assertion failed: _e_x_p_r_e_s_s_i_o_n, file _x_y_z, line _n_n_n
  21.  
  22.      on the standard error output and aborts.  In the error message, _x_y_z is
  23.      the name of the source file and _n_n_n the source line number of the _aaaa_ssss_ssss_eeee_rrrr_tttt
  24.      statement.  The latter are respectively the values of the preprocessor
  25.      macros ___________FFFF_IIII_LLLL_EEEE__________ and ___________LLLL_IIII_NNNN_EEEE__________.
  26.  
  27.      Compiling with the preprocessor option _----_DDDD_NNNN_DDDD_EEEE_BBBB_UUUU_GGGG [see _cccc_cccc(1)], or with the
  28.      preprocessor control statement _####_dddd_eeee_ffff_iiii_nnnn_eeee _NNNN_DDDD_EEEE_BBBB_UUUU_GGGG ahead of the _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee
  29.      _<<<<_aaaa_ssss_ssss_eeee_rrrr_tttt_...._hhhh_>>>> statement, will stop assertions from being compiled into the
  30.      program.
  31.  
  32. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  33.      _cccc_cccc(1), _aaaa_bbbb_oooo_rrrr_tttt(3C)
  34.  
  35. NNNNOOOOTTTTEEEESSSS
  36.      Since _aaaa_ssss_ssss_eeee_rrrr_tttt is implemented as a macro, the _e_x_p_r_e_s_s_i_o_n may not contain
  37.      any string literals.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.